| Davar4: MDK - Příprava modulů knih (DBK) |
|
Moduly knih mají strukturu podobnou Bibli, tj dělení kniha-kapitola-verš.
Pro jednoduché texty (bez vložených tagů) je relativně jednoduché připravit vstupní soubor data.txt z nejrůznějších zdrojů. Můžete použít např. text z online Biblí z internetu anebo export z různých biblických programů.
DŮLEŽITÁ PRAVIDLA:
1) Soubor data.txt vždy obsahuje jeden verš na řádek. Každý řádek je ukončen v editoru pomocí Enter (= znaky CR+LF)
2) V souboru nesmí být vynechané verše nebo kapitoly
Pokud ve verši potřebujete vložit nový odstavec, použijte tag |C
Pokud v textu chybí verše, použijte nějaký neutrální text, např. "---" a vyplňte korektně příslušnou referenci.
Příklad souboru data.txt:
|
; this is note
|
; this is note = poznámka, text je ignorován až do konce řádku, pokud je PRVNÍ znak ; (středník)
Ge 1:1 = text bez vložených tagů
Ge 1:2 = text s vloženými tagy hebrejských Strongových indexů, které jsou ihned za příslušným slovem. Např. earth|RH776|Rh což znamená že earth má H776. Je zde rovněž vložen tag pro slovo nepoužité v originále: |TUwas|Tu
Ge 1:3 = příklad chybějícího verše (v původním textu) a protože Davar nemůže pracovat s chybějícími verši, byl doplněn text "---"
Ge 1:4 = přiklad textu s tagem variant textu |TVthe light from…: Heb. between the light and between the darkness|Tv
DŮLEŽITÉ:
1) Jména knih ve výše uvedeném příkladu (Ge) nejsou pro konverzi důležitá. Místo zkratky "Ge" pro Genesis můžete použít "1" nebo "ABC" nebo "Genesis" nebo cokoliv jiného - což ulehčuje přípravu textu pro konverzi. Skutečná jména knih, která jsou vložena do modulu jsou zadána v souboru info.txt v sekci D4_Books= (viz níže).
2) Konverzní program na každém řádku hledá vzor název_knihy číslo_kapitoly:číslo_verše text_verše
kde pro detekci reference je důležitá část číslo_kapitoly:číslo_verše
poté následuje MEZERA text_verše ukončený novým odstavcem (CR+LF, což znamená že každý verš je ukončen klávesou Enter)
Poslední verš v souboru je také ukončený alespoň jedním novým odstavcem (CR+LF)
3) Nová kniha je detekována kdykoliv je číslo kapitoly a verše rovno 1. Např.: Ex 1:1 These are the names of the sons of Israel... tento verš je rozpoznán jako nová kniha, protože číslo kapitoly i verše = 1.
Příklad souboru info.txt, použitého pro konverzi KJV+ (vyznačeno modře tučně), následující řádek (červeně) je komentář a vysvětlení (není součástí souboru!). Všechny červené komentáře zde rovněž začínají znakem ; takže můžete tento text přímo zkopírovat do textového editoru a použít jako vzor pro váš modul.
|
;THIS FILE MUST BE UTF-8, Little Endian, without Byte Order Mark. New line is CR+LF pair ; pokud je znak ; použit jako první znak na řádku, celý řádek je ignorován (uživatelská poznámka) D4_OutputFile=kjv+.dbk ; jméno finálního výstupního souboru modulu, kjv+.dbk D4_Version_Major=1 ; hlavní a vedlejší verze. Toto je důležité v případě vydání opravených verzí modulů D4_Abbreviation=KJV+ D4_Title=King James Version Bible D4_Info=King James Version Bible 1611/1768. Include Strongs references and colored Jesus words D4_Copyright=Public domain text D4_URL=
D4_BooksNumber=66 D4_BooksExternNumber=0 ;0=latin book, 1=HE, 2=GR ; jazyk knihy v modulu. Všechny jazyky, které se čtou zleva doprava (L2R) jsou považovány za Latinku (=0), Hebrejština =1, Řečtina = 2 a knihy, které nejsou hebrejské, ale čtou se ve směru R2L = 3
; pokud je text knihy pouze prostý text bez tagů, použijte hodnotu =0. V případě výskytu alespoň jednoho tagu v textu použijte hodnotu =1. ;Here are standard Microsoft values for primary and secondary language of the book ; Pro řazení textů, program potřebuje znát HLAVNÍ jazyk knihy. Zde jsou použity Standardní hodnoty pro jazyky dle Microsoftu v hexadecimální formě. Úplný seznam hodnot najdete v souboru D4-specification.txt v MDK v sekci Identifier Predefined symbol Language. Některé často používané hodnoty jsou zde uvedeny v poznámce. Pokud jazyk knihy nemá sublanguage, pak na řádku použijte: D4_BookSubLanguage=0x00
;Tag flags: 0=tag not used,1=tag is used and default visible,3=tag is used and default invisible | ;Type of GR morphology:0=none,1=Tauber,2=Robinson,3=Packard ; seznam všech tagů, použitých v Davar4. Použijte pouze hodnoty 0 nebo 1 (zbytek ještě není funkční). 1= tag je použitý, 0= tag není použitý.
D4_Synchronize=1 D4_ScrollVerses=1 D4_JumpInside=1
D4_Books=
; velmi důležitá sekce. Tento blok obsahuje informace o všech knihách, které jsou zařazeny v modulu. První řádek: ;D4_Books= ;je ihned následován popisy, každá kniha na jeden řádek. Počet řádků MUSÍ BÝT PŘESNĚ STEJNÝ JAKO POČET KNIH, udaných dříve v sekci D4_Books= ;Každá kniha má následující parametry (např. pro řádek 1,OTGen,Genesis,Gen): ;1 = číslo knihy. Od 1 do D4_Books ;OTGen = jedinečný synchronizační název pro tuto knihu (Genesis). Úplný seznam najdete v souboru D4-specification.txt v MDK v sekci Reserved synchro names. ;Genesis = název knihy, která bude zahrnuta v modulu. Znamená to, že pro reference na začátku veršů v data.txt můžete použít prakticky libovolné názvy, protože bude použit zde uvedený název. ;Gen = zkratka knihy, která bude použita v modulu.
;If extern books are used, it is in format: ; pokud jsou do modulu přidány i externí knihy (viz poznámka nahoře!), pak můžete povolit (zrušit ; pro poznámky) tuto sekci. Vše je identické jako v sekci D4_Books= kromě prvního řádku, který je: D4_BooksExtern= ;poznámka: externí knihy jsou číslovány rovněž od 1.
|